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SCOPE 


This document describes the Burroughs Systems Communications 
Madule and establishes standards and guidelines for the system. 
The data communication procedures used are the S8urroughs Data 
Communications Standards as defined and pukilished by the Data 
Communications Coss#ittee and Corporate Engineering. Other areas 
of SYCOM>» such as record formats and supervisory messages are 
standardized in this document. | 


In addition to RIE» this protocol includes the features of file 


transfer >» program-to-program communication and the issuance of 
SPO commands between two computers (Cor from a terminal to a 
computer). These tatter features are symmetric, they may be 


invoked between any two systems without regard to “host” NS. 
"“terminat*® status. 


The functions that might be supported by a program inptementing 
this protocoi fali into three categories: host RJE» terminal 
RJE» and fite transfer. This protocot specifically atlows 
implementation of a subset> any one or any combination of these 
functions is allowed. 
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CEFINITION QF SycaM 


The purpose of SYCOM is to increase the use of data processing 


systems tocated some distance from each other. SYCOM tncludes 
remote job entry and fite transfer capabilities. In remote job 
entry» jobs are submitted through a remote terminat and 


transmitted via a data communications tine into the job stream of 
the host system. After prcocessings the job's printed and punched 
output is transmitted back to the terminal via the communications 
line. File transfer is the movement of files between two systems 
which can be either “terminal” systems or “*host™ systems. 


Since some of the functions of this prcetacct atfow interaction of 
2 peerctevei entities» the terms “terminal™ and “host"» although 
stidd used» are tess applicable. Most appticabte are the notions 
of “user” system and “server” systems as used in the ARPA 
Network. The user system is the active party with the human user 
Wishing to utilize a computing resources and the server system is 
the passive party supplying the computing service. 


The basic functions of SYCOM ares 


1. Introduction of programs from a remote input device for 
| compilation ana/or execution. 


2e Introduction of data from a remate input device for 
processing ty the host system. 


3. Dispersing of data and/or programs produced by the host 
system to the remote device(s). 


4e Monitoring and contrctling of programs on the host system 
via areracte supervisory consote. 


5. Transfer of fiies from one system to another. 


6- Support of communicaticn between programs executing on 
the two systems. | 


An implementation of this protocol should include a 
System=dependent way for a user program to initiate any SYCCY 
function. | | } 

Since SYCGM applications imply the transmission of targe batches 
of data between the two systems» tine throughput maximizations 
error detection» and error recovery are of prime tmportance. 
This section discusses those topics and the procedures and 
conventions usec in SYCOM applications. 


LINE THROUGHPUT 


Maximization of tine throughput is assured by the SYCGM 
pointsto-point message transfer crocedure which: ) 


ere 
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le. Specificatly acknowledges a message with either a message 
or a numbered acknowledgement C#ACK). This reduces both 
dine time and line turnaround per sgessage. | 


2e Bhocks records (that is» sends muitipie records per 
message). 


3e- Compacts and expands blankse It is common on card input 
and printer output to have a larce percentage of blanks 
imbedded in the data. Eliminating the transmission. of 
flanks can significantly improve throughput. 


4e Sends messages in one direction white error recovery 
proceeds in the opposite direction through the unique 
capability for inctusion of a specific acknowledgement to 
a received message within a transmitted message. 


ERROR DETECTION AND RECOVERY 


The following features are provided in the error detection and 
recovery areas to assure retiable service to the SYCOM user: 


1. A specific numbered acknowledgement Ceither in a message 
or in a #ACK) guards against the possibility of tost 
messages by providing an unambiguous acknowledgement to 
the transritted sessage. 


2o2 The use of at iteast madulo 2 transmission numbering 
facilitates the detection of duplicates. 


3-2 Dynamic reduction of the transmission message length 
provides the potential for reducing error rates and 
fetransmissions on bad circuits Cerror rates per message 
increase as the message size increases). 


4. The convention of different timeout vaiues for centrat 
and remote system alieviates tine cottlision problems. 


5S. The message transfer procedure etiminates the ambiguous 
os use of certain ASCII controt characters (for example» ENG 
is used oriy during establishments nowhere elise). 


6. Error detection is provided through the use of vertical 
and horizontal parity in SYCOM. | 


DATA COMMUNICATIONS PROCEDURE OF SYCOM 


The point-to-point communications messase transfer procedure 
adlows the reversal of direction of message transfer without 
separate establishaeent and termination procedures. Ihe essential 
characteristic of thts procedure is the ability to specificaity 
acknowledge a previous transmission via the use of a character 
tnciluded within the header of the message. Thts character wiit 
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hereinafter be referred tc as the ARM (CAcknonledge Received 
Message) character and wilt be defined to have the following 
values: A 


le ARM is the transmission number of the tast vatidty 
received messager or NUL» immediately fotlowing 
establishment. 


2e The ARM character immediatety fottows the SOH. 


The vatidity of the ARM character will not be considered apart 
from the vatidity of the message (that is» if a message has 4 
parity errors the ARM wiit be ignored). 


The usefulness of the ARM is twofotd: First» it provides a 
specific acknowledgement to a previcus transmission because of 
its "numbered ACK" facitity. Secondty» when a receiving station 
receives a message that it cannot accept because of a norbuffer 
or noteready conditions the ARM aliows the facility to implicitty 
NAK that message» while at the same time being able to transmit a 
new message and thereby possibly freeing buffers and/or conveying 
in the test the notcready cr buffer-fuilt condition. 


SYCOM HOSI SYSTEMS AND REMOTE TERMINALS 


The foltiowing systems have implemented or ptan to implement the 
following packages: | , 


hRJE tRJE FTP term 
87700/87800 C P P 
B6790/B6800 C P Pp 
Medium systeas Cc 
B1800/81700 C Cc P P 
BeCO C p p 
B80 c P p 
B771/B772 Cc 
TC5100 Cc 
T03500 C 
DC10090 c 
Where hRJE = hast RJE 
| tRJE = terminal RJE 
FIP = file transfer 
term = terminat-to-program and program-to-program 
| interface | 
C = currently available 
P = 


planned for implementation 
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SYSTEMS COMMUNICATIONS STANDARDS 
sYcon 


SYCOM defines the standard functional characteristics for a 
nontransparent half-duplex mode systems communications mechanis@. 


SYCOM DATA COMMUNICATIONS STANDARD 


This section defines the conversationat SYCOM Link procedure for 
operation over directiy connected» teased» or switched lines. 
This SYCOM link procedure is a subset of the Burroughs 


Conversational Point-to~Pcoint Line Procedure as defined in 
Burroughs Corporate Oata Communications Standards» Document 
1284 9006. 


CONVERSATIONAL COMMUNICATIONS PROCEDURES 


Figure 3°71 defines the basic conversaticnatl message transfer 
procedure. Conversational procedures aliow reversals of 
direction of message transfer without separate establishment and 
termination procedures. This figure applies to a point-to-point 
circuits» either switched or dedicated. The establishment ard 
termination procedures of figure 3-2 apply. An atternate timeout 
and recovery procedure is used whereby one station provides 
special timeout anc recovery services for the other station. 
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FROM ESTABLISHMENT WITH STATION A AS KASTER 
| NOTES 


1. {  } INDICATES OPTION THAT MAY BE EXCERCISED 
FOR SPECIFIC SYSTEMS. 


2. REFER TO "Message Transfer" 


. SO# 
AXM 
xMé 3. REFER TO "Retransmission of Messages" 
STX ; 
DAL (NOTES 2 & 7) 4. REFER TO "Parity or Block-Check Error Handling" 
DA2 pete 
F 5. REFER TO "Message Idle State" 
° 6. REFER TO "Normal Termination" 
TEXT 
e 7. #$TEXT LENGTH IS VARIABLE. 


FROM ESTABLISHMENT WITH STATION B AS MASTER 


NEXT MESSAGE 
[REPEAT] (NOTE 1) | 
w 
§ 


(prerix] [PREFIX] 
KAK ACK 


(NOTE 3) 


(NOTES 1 & 4) 


NEXT MESSAGE 


(prerrx] rl INR 
ACK \ 


(NOTES 1 & 5) 


en SE 


TO 
RECOVERY TO NORMAL 
TERMINATION 3 | . oe 
(ROTE 6) TO NORMAL 
| TERMINATION | RECOVERY 
(NOTE 6) 


[- Station A | "Station B | 


Figure 3-1 - Conversational Coasunications Procedures 
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Message Iransfer 


Message blocking is prohibited. Messages are delineated by 
special characters. A message begins with a SOH character and 
ends with a BCC character. The message stream is as follows: 
SOH» ARMs XM#e STX» DAL» CA2» the text of the messager ETX» and 
BCC. 


Retranspission of Messages 


If the master (transmitting) station does not receive arepty to 
its iast transmission within some peritcd of time» it may 
retransmit the unacknowledged message. | 


Parity or Block-Check Error Handiing 


If the shave station receives a recognizabte message» but it 
contains character parity error(s) or a btock check errors it may 
reply NAK. | The master station should retransmit the message. 
This may be repeated "n* times (n is user-specified and at least 
one)» and if the error persists» either station may exit to error 
recovery. 


Message Igte State 


If the siave station receives a good message» but has no traffic 
to send» it responcs ACK. If the master station has more traffic 
tt sends another messaqe. If the master station has no fore 
traffic» it proceecs to the sessage idie state. 


Normal Tersination 


The normat termination of a conversation occurs when one station 
sends ACK Cindicating that it has no more traffic to send)» and 
the station receiving the ACK atso has no more traffic. The 
Station receiving the ACK proceeds to the message idie state. 


POINI“TO-POINI CONTENTION PROCEDURES 


The essential characteristic of this procedure is that after the 
end of message transfer» as indicated by the transmission of the 
DLE E0T sequences hoth stations are in an idie status (neither 
master nor stave)» and that either station may bid for master 
status by sending the DLE EN@ sequencee See figure 3-2. 


304 


- BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GRCUP B1800/B1700 SYCOM 
SANTA BARBARA PLANT SDS 2222 2590 


Station A | | Station B 


FROM CALL UP | 7 
(IF DIALED LINE) 


START UP 
(NON-DIALED) 


DLE 
ENQ (REF. “Master Status”) 


aS 


[pRerix} PpReFzx } 
RAK ACK 


fas 
& 
w 
a 
2 
< 
, 
wv 
fi 


) | (REF. "Enter Message Transfer State") 


: sett ate aD Tt 
(REF. “Enter Message Transfer State") ‘ 


MESSAGE TRANSFER 


oe I 
°o 
i. 
2 | 
> os { 
o ERROR | 
a RECOVenY - 
: GO ON HOOK { J] INDICATES OPTION THAT MAY BE EXERCISED 
' (IF DIALED LINE) ; FOR SPECIFIC TERMINALS AND/OR SYSTEMS. 


Figure 3-2 Point-to-Point Contention Procedures 
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Master Status 


If either station in the idie state wishes to enter message 

transfer» 3t may bid for master status by sending DLE ENQ. I f 

the same station had just terminated message transfer by sending 

DLE EDT» it is recommended that there be a delay before this 
Station sends DLE EN@ again. 


Enter Message Iransfer $tate 


If the station bidding fer easter status receives an ACK 
{indicating ready to receive) it may enter message transfer. If 
the response is NAK {not ready to receive)» the DLE ENQ may be 
repeated up to a retry timit cf *n's (n is user-specified and at 
feast one)» and if no valid response is receiveds go to error 
recovery. If the station bidding for master status receives DLE 
EFNQx indicating that the cther station is bidding at the same 
time» it shali abandon its own bid and repty in accordance with . 
its readiness to receive. In order to avoid continuing line 
collision when both stations are bidding at the same timer» the 
no-response timeout vailues should be of different length. 


Terg@ination 


DLE EDT is transmitted to indicate the end of this session and» 
if switched tines» to disconnect the modem by going on hook. 


R STADL] SHMENT 


SET ARM TO 
NULL 


INIT XMé@ 


SEND ACK 
Hau TO No 


XMIf o (NIT 
ARH# « 9 
SIART No 
RESHOLSE 
‘TIMLR 
START NO 
RESPONSE 
YES TIMER 
YES 
NC 
YES 
NO 
pie gor Sy ZS 
DISCONNECT ys 
oe | GO TO -. NO 
2 
SEND 
DLE EUT 
CONT OPRTR 
INTER= 
TENTION 
NO YES 
DISCONNECT | 
ut . 
7 HOOK 
ener LOGICALLY at 
DISciscHkCTED & PHYSICALLY : 
ash DISCONNECTED 
(SEE NOTE) (SEE NOTE) 


NOTE: NEXT SESSION MUST 
EEGIN AT ESTABLISHMENT . 


ES NO 
RELEASE MSS ° 
FOCGLE XMLT# ‘0 
(SEND) les 
RESET RETRY 
xO Yes 
ACCUMULATE 
MESSAGE 
INVALID 
CHAR 
DUPLICATE 
MESSAGE 
COPY #XM/R) 
TO AkM(S) 
DID I 
SEND MSS 
NO 
MSC 


TO SEND 


RELEASHE MSS 
TOSGLE 
XMe(S) 

RESET RETRY 

COUAT 


SEXD ARM(S) 
ACK 


VeavVGuVa VENVS 


dNDYD SWILSAS Y3SLNdWOD 
NOFTLVe¥OduDD SHONOYNA 
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SYCOM PROCEDURE 


The SYCOM flow chart provides a logic diagram of the detailed 
SYCOM procedure (see figure 3-3). Information and definitions 
for understanding the procedures are as follows: 


le 


The SYCOM procedure attows reversals of direction of 
message transfer without separate establishment and 
termination procedures. A message can be positively or 
negatively acknowledged with another message. This 145 
accomplished by the use of the ARM CAcknowledge Received 
Message) character (defined below) contatned within the 
message header. 


Message biccking is prohibited. Each message is one 
btock long» beginning with an SOH and ending with ETX 
foilowed by the 6CC. The messacge header contains four 


characters defined as: SOQH» ARM» XM#» and STX. 


The ARM character indicates ACK or NAK of the previous 
message with respect to the validity or invatidity of 
that message. I[t is inctuded: | | 


ae within the header of each message. 
be aS a prefix to an ACK character. 


The ARM widi be initialized to a NUL character (00) 
during the establishment phase of the procedure. When a 
valid message is receiveds the XM# will be saved and used 
as the next ARM character transmitted. [t will be set to 
the NUL character vaiue until a valid message has been 
received. 


When an ARM sequerce CARMACK or SOHTARM) is received» it 
wiid be cogpared with the tast XM# sent and» if equat>, 
the fast message wilt be positively acknowledged. It the 
sequences cdo not agrees the tast message has been 
negatively acknowledged and wilt be retransmitted. 


The validity of the ARM character will be checked only if 
a vaiid header and message is received» that is» the AR* 
character wiil be assumed to be a NAK untess received in 


the header cf a valid message or in a valid ARM-ACK 


reply. 


The XM# is a one-character field. The recommended modulo 
2 character sequence is F/U for the host» and 5/& for the 
terminal. The XM#"*s received will be checked against the 
previous XM# received and» if equat» a4 duplicate text is 
assumed and the text is ignored. It shalt hereby be 


noted that the NUL character (00) must not be used as a 


transmission numbers after the first transmission. 
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5- An invatid character punched in the first cotumn of an 

' §8Orcotumn card Cor a question mark character in the first 

column of a 967cotumn card) is reptaced by a NUL 
character (€00) pricr to transmissicn. 


6. Recoamendec timeout values for Invalid or No Response are 
2e5 seconds and 3.0 seconds for terminal and =host 
respectively. 


CODES AND ERROR CHECKING 


Character parity checking and fongitudinat parity checking are 
used. An error in either check constitutes an erroneous message 
and wit be negatively acknowledged. The character code used is 
the American Standard Ccde for Information Interchange CASCIT) 
ANSI X3.4 1967 CAppendix A). Each character consists of seven 
data bits and one parity bit. The parity checks are: 


le Longitudinal Redundancy Character (C(LRC). This is a 

| redundant character added to the end cf a transmission 
block for the purpose of error detection and control. 
The LRC is ecbtained as the binary sum (Cinitiatized to 
zero) without ‘carry* on each of the bits of the 
characters fottowing SOH» including ETX. The polynomiat 
usec in this "cyclic*™ accumulation is X to the power of 
eight pius one. : : | 


2- Character Parity. Ati characters» inctuding the LRC» . 
shati have the same parity. Synchronous transmission 


uses odd character parity and asynchronous’ transmission 
uses even character parity. | 


~SYCOM RECORD (TEXT EFEQRMAT 
The SYCOM record format is as foiloaws: 
OAL DA2 (CCI <text> ERS CCC] <text> ...] 
or DA1l DA2 £CC} FS 0 <text> 
or DA1 DA2 CCCI] FS 1 <text> 
or DAI DAZ (CC] FS 2 <text> 


where: 


DAL and DA2 are device addresses indicating the source or 
intended destination of the text. 


CC is used for control of special functions. 
FS is the file separator. 
RS is the record separator. 


<text> is a unit record, optionaiiy modified by space 
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compression and by detetion of trailing spaces. Att text 
within a message is addressed to the same device. 


OQEVICE ACORESSES CPALe DA22 


DAL and DA2 wiit be used for device addresses at the remote 
Station. The convention used is: 


DA1 DA2 Usage 
0 0 System controt 
0 1 SPO 
0 2 Card reader/card punch 
¢ 3 Line printer 
0 4 Data of a file transfer 
0 ; 5 
through Peserved for expansion 
8 1 | 
8 2 Packed punch 
8 | 3 | 
§ through Reserved 
9 | 9 
a A User host transmits» or 
through  gerver host receives 
z Z Virtual station data. 
A a User host receives, or 
through server host transmit» 
2 2 virtual station data. 


See TERMINAL~“TO-PROCGRAM COMMUNICATION for more information on 
virtuat station data. The device addresses are advisory oanty. 
The remote staticn may redirect a message to any appropriate 
devices based upon its own requirements. 


Note that tine printer data is atlowed in either direction. then 
a system receives tine printer data» it prints it on an available 
printers independentiy of whether the system is “terminai” or 
"host*. | | 


DEVICE EUNCTIONAL CONTROL coc) 


A onecrcharacter fieitd (CC) is used for controt of speciat 
functions. The CC fietd is required and is valid only § for 
messages addressed to a Line printer. The CC fieid witt always 
appear as the first character of a record when DA1=0 and DA2=3>» 
indicating that these records are destined for a line printer. 
The CC fieid controis the printer's vertical motion according ta 
the following conventions (skip-to-channel ts subject to hardware 
implementation): : 


3-10 


BURROUGHS CORPCRATIGCN COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GRCUP BL8OC/B1700 SYCOM 
SANTA BARBARA PLANT SOS 2222 2590 
CC Function 
0 Prints» no spacing 
1 Prints then single space 
2 Prints» then double space 
3-9 Reserved for expansion 
A Skip to channet 1 - top of page 
B Skip to channel 2 
Cc Skip to channel 3 
) Skip to channel 4 
E Skip to channet 5 
F Skip to channel 6 
G Skip to channel 7 
H Skip to channel 86 
I Skip to channel 9 
J Skip to channel 10 
K Skip to channel 11 
L Skip to channei 12 7 end of page 


EILE SEPARATOR SES) 


A separate message containing a file-separator character (FS) is 
used to separate files. The character following the FS is either 
"QO" » a1" > or "2% indicating beginningcrof header » 
beginningrof-file or end-of-file» respectively. The text portion 
of the beginningcoftheader or beginning-~of-file separator record 
contains the file name. This name may be used at the terminat'’s 
discretion. | 


Example: begin header: SOH ARM XM# STX O3A FS O <text> ETX 
begin file: SOH ARM XM# STX O3A FS 1 <text> ETX 
end filte: SCH ARM XM# STX O3A FS 2 ETX 


The file-separator record is sent from either system signifying 
that the beginning or end cf file has occurred for this devices 
or to prefix a copy of the file*s symbolic file header (see 
MAINTENANCE OF FILE CHARACTERISTICS for mare information). | 


RECORD SEPARATOR (RS) 


Records are separated by the use of the ASCII controit character 
RS. Character RS is not an end-of-record or a 
beginningroferecorcd designators but is only used between records 
as a separator when several unit records are combined into a 
Single SYCOM message. SPQ records are never combined. 


SPACE COMPRESSION 


A sequence of consecutive space characters»s up to 99 in tength>» 
may be replaced by an ASCII escape controt character CESC) 
followed .by a two-character decimat number containing a count of 
space characters replaced. Greater than 99 consecutive space 
characters wiit require two or more ESC sequences. Trailing 
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tianks may be truncated. SPG oar packed records are not 


space-compressed or truncated. 


2YCOM SYSTEM MESSAGES 


In addition to the standard datacomm controt interface» systems 
in the SYCOM envircnment need to communicate certain information 
via systam messages to insure orderty operation. System messages 
are those messages whose DAL and DA2 characters are 00. 


SYCGM system messages are tworcharacter decimal codes» foilowed 
in some cases by additional data. In the following definitions 
the code witit be tisted foltcwed by its definition. The 
definition will be enciosed in parentheses.j Beneath the code and 
definition witli be an explanation of the code. The following are 
currentiy defined: 


Q1 (Logged On) 


Sent by the host system to the remote terminal to inform the 
terminal that the operator using the terminat has been logged 
GNne 


O2DDDD Cauffer Size) 


Sent from either systems requesting a change in the length cf 
messages being assembied for transmission. DDDOD is the 
requested message tength in decimal notations e.ge» 0200 
means a maximus message size of 200 characters. Initial 
defauit buffer size is 402 (number of characters between STX 
and ETX). | 


A Buffer Size Request message is atways answered with a 
Buffer Size Reply (04) message. Upon being Logged ons the 
terminai should send this message to the host specifying the 
size of the targest message it can receive. Thereafters this 
message may be sent to request an increase or a decrease in 
actual message size. A decrease might be requested to reduce 
error rates on a marginat circuit. 


It is important to note that the absotute maximum tength of 
messages which wild be accepted on input is specified only ty 
the initial exchange of Buffer Size Reauest and Buffer Size 
Reply messages. Subsequent requests exceeding the original 
specification widi resuit in message tenaths conforming to 
this specification. | 


03 (Logged Off) 


Sent from the host to the remote terminal to indicate that 
the terminat is no tonger logged onto the host systen. 


940000 (Buffer Size Reply) 
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Sent from either system as a repty to Receive Buffer Size 
request (02) message. ODDO0D is as defined for Suffer Size 
Request. When reptying to the initiad Buffer Size Request 
Cafter tog on)» the host system witi specify the largest 
message it can receive. After the initiat Buffer Size 
Request/Buffer Size Reply message exchange» either system 
wili reply to a Buffer Size Request messace with a Buffer 
Size Repty message containing the maximum tength of message 
that tt wills» henceforth» assemble. This length wittl be the 
smaiter of the fcilowing: 


1. The requested length. 
2-e Its waximum buffer size. 
OSEDALILOAZ] CfLevice Net Ready - Suspend) 


Sent from either system instructing the other to suspend 
transmitting messages for DAL and DA2. Incicates a temporary 
condition at the device (e.ge» tine printer out of paper). A 
Device Ready (07) system message should be sent to resume 
transmissions when the condition is corrected. If the 
condition ts not corrected» a Device Not Ready Abort (06) 
System message should be sent. | 


O6LDALILDAZ] CLevice Not Ready = Abort) 


Sent from either system informing the other that = an 
uncorrectable ccndition exists preventing the processing of 
additional transmissions for device DAl» DA2.]j #£=The received 
messages for that device are discarded. The transmitting 
System must preserve the entire file. 


O7EDALICDAZ) (Device Ready) 
sent from either systen: 


te After a Device Not Ready (05 or 06) system message to 
indicate that the condition has been corrected and 
the device ts again ready to receive datas or 


2. Whenever a device which was unavailable becomes 
avaiiabie to receive datas or 


3e Immediately after a Logged On (01) system message to 
indicate each device that is ready and avaitabie to 
receive data. (Optianai) 


QICCCCLVVDDSSS (CStation-1d) 


Sent from either system prior to logging on to provide a 
positive means of identifications independent of any security 
function. This message includes the sender*s CPU modet 
identification and an tndication of which part(s) of the 
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protocol he has implemented. A terminal must be prepared to 


accept this message. 


"0D" is the number of characters in *SSS",» which is the 
sender's station identifier (between 1 and i7 characters 
lang» inclusive ). "cccCc*™ is the sender's system type» 
deft-justified and padded with blanks to 4 characters (e.g. 
“17007 >» "6700%» “771 *). (This atlonws simitar systems to 
identify each cther and engage in specialized communication 
inappropriate between dissimilar systems.) "“L™ is a character 
that indicates which parts of the protocot the sender 
supports. It is constructed as fotlons: The high-order two 
bits are Ol» the next three hits are OC» and each of the 
lowcrorder 3 bits corresponds to one part of the protocol: 
hex 1 bit set means “can act as host™»s hex 2 means “can act 
as terminati"» hex 4 means “can do file transfer”. (For 
example» an ASCII “A™ would mean “can act as host"» or ASCII 
"E™" means “can act as host and can do fite transfer*.) "VV" 
is a 2*character decimal number indicating the version of the 
protocot impiemented by the senders this document 1s version 
gall! eae | 


This message may be sent by either system. On receipt» a 
host may initiate a lLog-on sequences tut a terminal may not. 
In the case of 2 hosts communicating with each others» either 
one» both or neither may tog on to the other. If coth 
Systems send this messages they may not both specify. the same 
Station identifiers since this is used as the “host name" 
eisewhere. 


10 (Put Fite) 


Contains identification of the user originating the request 
and filename and attributes of both source and destination 
file (see "Format cf Put/Fetch Messages® for complete. 
definition of format). The *Put™ message elicits a response 
of *Put repiy”™. : _ 


11 (Fetch File). 


Contains identification cf the user originating the request 
and fittename and attributes of both source and destination 
file (see “Format of Put/Fetch Messages® “for conmptete 
definition of format). Elicits a response (perhaps after a 
time tag) of "Put Fite". 


12TUUUUtext (User-destined Message) 


“T" specifies whether destination is the SPO ("0")> a user 
program ("1% )» or aeouser at aterminat €°2"). “YUUU" 
identifies the user program or terminal» ina system-defined 
Maye In any casep "“text™ is routed to the specified 
destination. 
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L3TUUUUtext (MCP Command) 


*"TUUUU* identifies the issuer as in “User-destined message” 
and “text" is the MCP commande This text is to be executed 
as if it had been entered at the SPQ. Note that security 
considerations are not part of this protocol (perhaps 
usercode/passucrd information could be included in the text 
in a system~-dependent way). 


15 (Clase Request) 


The recipient is to terminate the session in an orderily way» 
after completing any fite transfers it is currently 
executing. The sencer only sends this message when it is not 
transmitting any files» and the receiver responds with a 
Close Reply when it is not transmitting any files. 


16 (Close Reply) 


Sent in response to a Close messagee- Qn exchange of Close 
repties» both systems are to terminate the session and break 
the connecticn. If a switched line» both systems hang ups 
if aiteased tine» it is an implementation decision whether to 
re-establish or not. 


17CC (Put Repty) 


Sent in response to a Put message to indicate initiad success 
or failure of the file storage request. "CC" is the outcome 
codes “OO" ais success» "O17" is "failed for tack of 
resources” Cinctudes "packname not found"™» and “no more disk 
space”) >» "O02" Its *failed for security violtatiaon™» "93" is 
“failed for invaiid filename syntax” and "04" is "faited for 


unimplemented cevice or file attributes”. Impiementers are 
encouraged to distinguish between various cases of these 
errors» anc tc recognize other errors; the user should te 


supplied with information as specific as possitle. New error 
codes wifi be added as needed. 


18 (Abort Put) 


Sent from either system to request that its current PUT be 
aborted» and that any portion of the file already written te 
discarded. If no PUT ts in progress» this is a NOP. 


19 CAbort Fetch) 


Sent from either system to request that its current FETCH be 
aborted» and to advise that any portion of the file aiready 
written has been discarded. If no FETCH is in progress» this 
is a NOP. , 
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20VVcharacteristics (Connect ) 


Sent from user system to server system to request 


establishment of a terminal-to-program connection. "VY" is 
the virtual station adcress to be used for the proposed 
connections and as the user system*s transmit address. 


“characteristics” describe the characteristics of the reat 
terminals to altow the server program to format messages 
appropriately» if desired. The characteristics» taken from 
Common NDL» ares 7 


Station IC | 20 characters 


fine width 4 characters 
CRY boolean 1 character 

"9" = not CRI | 

“is ad CRT 
MYUSE 7 1 character 

"1" = input anly 

"2" = output onty 

"3" = tnput/ocutput | | 
Maximum input dength 4 characters 
maximum output fength 4 characters 
page size Cin characters) 4 characters 
terminal type (from user systen 20 characters 


| NDLs ieft-justified) 
21vV¥CC «Connect Repty) 


Sent from server system to user system to respond to 2 
Connect messagee States whether or not a terminai-to-progran 
connection has been established for virtual station nuster 
"vv" Cuser system*®s transmit address) via the response code 
“—CC*s "00" for successe “Q1" for invalid address or system 
full,» and "02" for no MCS reading on station. 


Z22VV CDisconnect ) 


Sent from user system to server system to break an existing 
terminai-to-program connection for virtual station address 
"vv". There ts no reply. a : 


23 (EOF Confirmation) 


Sent by a system receiving a fite> after completing ait 
processing of it» to confirm receipt of the sender*s end of 
file. Aliso sent at connection-establishment time if no file 
is heing received» to synchronize the two systems after a 
crash.» (See FILE TRANSFER RECOVERY for more information.) Cn 
receipts this message is ignored if no PUT is in progress. 


System messages 05. through OF may contain one or more 
concatenated device addresses (DAl» DA2). 
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The following chart of system messages depicts the requirement 


for implementation of these messages for both one host system and 
the remote terminal: 


iNessage {i , Host Systen i Terminal System 

§ Code Recv Send i Recy send 
{ses ees oe] $4 sess SS S94 SSS S666 eS Se See Sen amas ow Cnn wanna anaes 
! 31 § Not required Mandatory ! Mandatory Not required 
t 02 ! Mandatory Mandatory i Mandatory — Optional 

i 03 { Not required Mandatory i Mandatory Not required 
§ O04 i Mandatory Mandatory 1 Mandatory Mandatory 
305-07 & Mandatory Optionat i Mandatory Optional 

i 09 § Mandatory Optionat i Mandatory Optional 
10°22 4% Optionat. Opticnal 1 Optionai Optional 
Notes Message codes greater than 03 are not imptemented by 


OC1000. Message codes 10°19 are file-transfer related; 
if file-transfer is implemented» they are mandatory. 
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CQORMAT OF PUIZEETCH MESSAGES 


Foitowing is the format of the Put and Fetch messages» starting 
with the first character. after the system message code. The Put 
message is identicat to the Fetch message except for the aessage 
code (note that the Put message has no logical need to specify 
the source file identification; this 1s included for 
consistancy). Ait numerical vatues are specified in character 
representation of cecimat vaiues» and have maximum vaiues of att 
9*s. 


O1 PUT_OR_FETCH_fECORD> 


02 REQUESTOR CHARACTER CO6)> 
03 REQUESTGR_TYPE CHARACTER(1)> 
% 0 = SPO user . 

Z 1 = user progran 


terminal user 
03 REQUESTOR_ID | CHARACTERC4) > 
2% program ident or terminal ident. 
O03 REQUESTOR_CIRECTIGN CHARACTERC1)» 
z P original request was "PUT 
x F original request was "FETCH" 
02 REPLACE_FLAG CHARACTER(1 D> 
| x 9 do not replace existing file 
x1 replace existing file Cif any) 
O02 ORIGINAL_SYSTEM_TYPE CHARACTER(C4)> 
% in the same fcermat as | 
Z *"CCCC*™ in staticn-id message 
O02 BEGINNING RECCRD_NUMBER CHARACTERC8)> 
Z record number at which to 
% start transfer 


a 


02 RECORD COUNT CHARACTER (8)>» 
% number of reccrds in file 
O02 RECOVERY_FETCH CHARACTER (1 )> 


0 = not a recovery FETCH 


; y a | this is a recovery FETCH 
02 SOURCE_FILE CHARACTERC1I74 )>» 
03 FILE_NAME CHARACTER(100)> 
03 DEVICE_KIAC CHARACTER (2)>» 
% 00 = disk | 
Z O01 = tape Cany avaitable) 
Z 02 = I-track tape 
Z%Z 03 = T-track tape 
% 04 = phase~encoded tape 
03 RECORD_SIZE CHARACTER (4) >» 
03 BLOCK SIZE CHARACTER C4)» 
O3 PACK_NAME CHARACTER(C17)>» 
03 FILE_K INO CHARACTER (2)>» 


% 00 = code file 

2 01 = data file 

%Z (Cother types may be added) 
03 USERCODE CHARACTER C17)3 
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03 PASSWORD CHARACTERC17)3 
02 DESTINATION FILE CHARACTER (C174 )3 


4 (format same as "SQURCE_FILE) 


In this record» the source FILE_NAME is in whatever syntax is 
approprtate for the source systems and the destination FILE_NAME 
syntax is ‘appropriate for the destination system. If an 
implementer wishes to atlicw transfer of a file famiiy» he must do 
so by initiating one transfer for each member of the family. The 
destination file must be created with the specified FILE_KIND» so 
it wiil be of the same type as the source file. Note that the 
source and destination RECORD_SIZEs must be the same. Note atso 
that a system is not required to tmplement att values for alt 
optionss if it receives a request specifying a device kinds file 
kinds oar size parameter that cannot be handted»s it may return an 
error of “unimpilemented option”. 


FILE TRANSFER 


File transfer is supported for disk and tape devices» and fites 
may be transferred between any combination of these. Tape 
transfers are restricted in that only one file per tape may be 
transferred» ang dibrary-maintenance (load.dump) tapes are not 


'. supported (these tapes may be transferred by loading to disk 


before transferring}. Between dissimitar systems oniy code fites 
and 8-bit data files Cincluding text files) are atlowed. Simiiar 
systems are perreitted to agree to transfer other files (e.ge» 
printer backup fiies» arbitrary frame-size fites). The protocol 
aldows transfer of oniy one file at a time in each direction. 


The user initiates a fiitie transfer by entering a variation of the 
CSG standard “COPY” statement. This command specifies source and 
destination hosts for the transfers by naming their "host names*. 
These two names must be the names specified in the Stationcid- 
system messages at initialization. If the specified source host 
is the locadl host» the transfer is a PUT; if the source is the 
remote hoster the transfer is a FETCH. | 


The actual transfer of a file is initiated by exchange of control 
information between systemse All transfers occur as PUTs>; if 
one system wishes to do a FETCH» itt sends a Fetch message to the 
other systems which causes it to initiate a PUT sequences sending 
a Put message. The Fetch and Put messages completely specify 
both source and destination fide. The Put message elicits a Put 

reply» signifying that data transfer may begin. The sender then 
sends one or more cata messages (device adaoress 04) foiliowed by 
an end-ofcfile message. | | | 


Qn completion of file transfer» the system that received the file 
informs the original reauestor of completion of the request. = If 
the requestor is foreign to this (the receiving) systems the 
notification is by a User-destined message. 
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The exchange of messages for a file transfer is diagrammed pelow: 


S—0011 Fetch» attributes 

0010 Puts attributes —> 

<— 0017 Put reply» success/failure code 
04 Beginning cf header —» 
04 File header data —~> 
04 Fiie header data ——> 
04 Beginning of file —> 
04 Data —— >» 


04 Data —~> 


oO .—] 2 


<=— 000504 Device not ready» suspend) Cif 
needea 

<=— 000704 Device ready for fiow 
controi) 


2 Ld .] 


04 Data ——~> 
04 Enc of file — > 
<— 0023 EOF confirmation 


If either system wishes to abort a file transfer in progress (for 
any reason)» it sends a 0006 "Device not ready = abort” message. 
As shown in the diagrams the 0005 “Device not ready - suspend” 
and 0007 "Device ready” messages are used for flow controi. 


MAINTENANCE QF EXILE CHARACTERISTICS 


A goal of the file transfer mechanism is tc maintain as many of 4 
file"s characteristics as possitle across the transfer. For 
examples if a FORTRAN source program is transferred» it shoutd te 
capabie of being ccapiled without further wodificatton» and if a 
code fite itis transferred to a tike system» it shouid te 
executable without further modification. 


Specificaity» if a fite is transferred between two like systems» 
even if via one or more untike systems» all of its 
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characteristics must be preserved. To accomplish this» a 


* symbolic version of the file's file header Cunderstandable to ait 


systems) is transferred with the file. This symbolic fite header 
is the same as that used by the CSG standard tibrary tape format. 
It is prefixed in the data stream by a beginningrof-header FS C 
message and may comprise one or more data messages. 


When the symbolic file header is received» it is parsed and as 
many of the file characteristics therein as make sense on the 
receiving system are incorporated into the file being created 
(this may be ali the characteristics or none). If the file is 
transferred to a system type other than the one where it was 
originaity created>s the symbotic file header and original system 
type are saved with the fite» to be forwarded with the file 
whenever it is again transferred. If the fiie is transferred to 
its original system types the entire symbolic file header is 
incorporated to create a file identicat in characteristics to the 
original file» and the symbolic header is not saved. 


When a system sends cne of its own files» it must include in the 
symbolic fiie header enough information for it to recreate that 
file if returned» so as to took identical to the original file>» 
with the exception of filename (this is conveyed in the 
PUT_OR_FETCH_RECORD). 


Not every file transfer witt include a symbolic fiie header. 
Some systems may not be ahie to save symbotic headers» and so 
wilt not be abie to forward them on subsequent transfers (Cbut 


this aust be advertized). Aisoe a foreign-created file may be 
modified or reptaced tiocatty» thus invalidating the saved 
symbolic header. In this case» the symbotic header may  0obe 


x OMitted>s or usec to describe the file according to its new 
. creation system type. 


The means of saving the symbolic file header and associating it 
with the file are implementation choices» but here are four 
suggestions» the first three of which probably require MCP 
changes. : 


ie Save the symbotic header as an extenston of the real 
headers gaintained by the MCP. | 


2e Save the symbotic header within the data of the files but 
hidden from att programs except SYCOM (for example» if 
the fite is FORTRAN sourcere the symbolic header must te 
invisible tc the FORTRAN compiler). 


3. Save the symbolic header in a secondary file given a 
unique name that can be inferred from the name of the 


data fiie. In the case of tape volumes» the secondary 
fide could be the second fite on the tape» after the data 
file. 


4. Save symbolic heacers for ali files received by SYCOM in 
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a commor directory file maintained by SYCOM. 


Atternateiy» one such directory file could be maintained 
on each volumes cantaining symbolic headers for data 
filies on that volune. 


FILE LRANSEER RECOVERY 


Any file transfer operations that cannot be executed when 
requested because another transfer is in progress must be queued 
Cin a non-volatile medium) and executed when possible. CALL 
requests are queueaq as PUTS» so if a user requests a FETCH» the 
request is sent to the other SYCOM» where it is queued as a PUT 
on that system.) | 


During a fiie transfer» both SYCOMs must maintain enough 
information that if one or both systems fail» the transfer can ce 
restarted at the point it was interrupted (rather than at the 
beginning). This means that white sending a file» SYCOM must 
remember (in a nonevolatile way) that it is sending a file>» ana 
that white receiving a files SYCOM must remember (Cin 4 
nonevolatite way) that it is receiving a fite» and how many 
records have been actuaity written to the destination file (the 
non-volatile copy of this vaiue need not always be absotutely 
current). | 


Whenever the SYCOM connection becomes established (regardiess of 
which SYCOM came up first)» each SYCOM tooks to see it it was in 
the process cf receiving and/or sending a file~ If in the 
process of receiving a file» SYCOM sends a FETCH request 
specifiying that this is a recovery request and specifying the | 
number of the record with which to restart the transfer. If not 
in the process of receiving a file» SYCOM conveys this fact via 
an EOF confirmation message to the other SYCO# for 
synchronization purposes. If SYCOM sees at establishment time 
that it was in the process of sending ae files it hotds that 
request in abeyances pending receipt of the recovery FETCH 
request. On receipts» it restarts the transfer at the specified 
record number (Cit is recommended that this be done in a 
direct-access way rather than skipping through the records to 
reach the desired points but whether and how this is done is left 
to the implementor). (Note that since a given SYCOM can te 
sending and receiving a file at the same time» it must make toth 
of the above checks at connection-establishment tine.) 


When SYCOM natices the other system breaking the connection on a 
Switched tine» it should wait for re-establishment and verify the 
host name specified in the Staticn-id message. If connection is 
rerestablished on the same liner but the host name is different», 
ait file transfer requests invotving that host are purged. 


TERMINAL SYSTEM BESSAGES 


Atl instructions tc or repiies from the terminat are caited tocal 
messages. Ait local messages start with a period €.). Messages 
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not starting with a period are assumed to te input or output to 
or from the host system. The foilowing set of tocal messages is 
recommended. | 

Note: These messages are meant to be a guideline and depend 


upon the particuiar needs of an installation. 
1. The unit device identification scheme normatly used by a 
terminat shoutd be substituted in the following messages 
“wherever “x" appears. 


2. If device mnemonics are used» the following standard 
applies: 


ae CP - Card punch 

be CR = Card reader 
ce LP = Line printer 
de. MT = Magnetic tape 
e. CS - Cassette 


INPUT MESSAGES 


eCL MT x Causes the magnetic tape buffers associated 

| with drive x to be discarded and the tape 
rewound. 

eCL x Command te be given to clear buffers in the 


event device x becomes inoperabie during 
transmission or reception of data. 


eCONTINUE Re-establisnhes the retry iimit and continues 
to attempt to communicate. Operator 
initiated when any of the fottowing output 
messages have occurred: 


oDSET“NR 
oNSPEXP 
oe RX“RTYS-UP 
2 TX*RTYS“UP 


DISCONNECT This witil terminate the operations send the 
host an endof-transmissiton indicator and 
place the terminait in the offriine mode of 
operation. | 


eI GNGRE x This message can be entered in response ta 
the local output message: : 


oMYT x PE Wheres x = Unit # 
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eONLINE Chostnane] 


PURGE x tttttt 


eREADY x 


eRETRY x 


eoRY x 


| -SIZE=nnn 
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It causes the tlast record to be re-read 
ignoring any parity errors. 


Places the local system in the ontine modes 
attempting to establish or reestablish 
communications with the specified host 
system. If no hostname if specified» or the 
last-named host is specified» re-establishes 
connecton to the last-named host Cif 
connection was broken for some reason). If a 
hostname ether than the current one is 
specified» this command breaks connecton toa 
the current host if necessary» and 
establishes connection to the specified host. 
C If the host system 4S accessed vi3 4 
switched line and its telephone number has 
been specifted via .PHONE» .ONLINE tnittates 
diat-cut.) Invalid cccurrences of this 
command are: the first .ONLINE has no 
hostnames» an »~ONLINE command with no hostname 
when the connection already exists» and an 
eONLINE command specifying the current host 
when the connection to it already exists. 


Write a tape label on magnetic tape drive x 
with the 1D of tttttt. The foliowing rules 
apply: | 


1. The tape tabet (tttttt) must be six 
characters. If fess than six characters» 
the tape is considered a scratch tape. 


2- The tape cannot be in use when the 
command is issued. 


3@ If no tabet Ctttttt) is specified» the 
tape 1s made into a scratch tape. 


Read tape tabel on magnetic tape drive x and 
Gisplay tabel on SPO. : 


Informs the system to retry reading the 
record in question from magnetic tape drive 
Me This entry can be made in response to 
focal cutput message «MTP x PE. 


Inforas the SYCOM terminat system that unit x 
is available and ready. Initiates system 
message code O07. 


Informs the SYCOM terminal system to set the 
block size of information to be transmitted 
to the central systems equal to nnne The nnn 
must be tn the range of 80 to 4025 inctlusive. 
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»STOP 


eoV xX 


SOS 2222 2590 
Initiates system message code 02. 
This entry witl cause a terminal to revert to 
a non-SYCOM mode if appropriate» and sends a 
Close message to the remote system to request 
it do the same. oe 


Directs the terminat system to inform the 


host systea to cease transmitting or 
receiving data from device x and to save the 
entire current file. Initiates system 


message code 06. 


COPY filename (CUSER=a»PASSWORD=b» VERSION=i»CYCLE=j )) 


AS 
| 7 { fitenane { (USER=c»PASSWORD=de VERSION=meCYCLE=n) 1) } 


ONTO 


PACK 
TAPE 


FROM {votume] (€ CKIND= ( PETAPE) »] HOST=hostname) 


TAPE? 
TAPES 


PACK 
TAPE 


TO Cvolume}] € CKIND= 4 PETAPE? »] HOST=hostname) 


"ONTO" 
“vyolume™ 


“KIND=* 
"DISK" 


TAPE? 
TAPES 


denotes choice of items. 

denotes optional item. 

denotes variable name. 

denotes literal text. 

means “create anew file of this name*. 

means "write over existing file of this name™. 
defaults to system disk Cif "KIND=" is aiso 
defauited). 

defauits to "HK IND=PACK*™. 

is an abbreviation for *“KIND=PACK*". 


"USER=a/b” 18 an abbreviation for “USER=asPASSWORD=b". 


Transfers the specified file in the direction 
specified by the source and destination 
hostnames. User/passwerd vaitues identify the 
user for purposes of verifying access rights 
to the specified files and perhaps also 
affect cdefauits fer parts of the filename. 
Source user/password default to those of the 
logged-in users and destination user/password 
dcefauit to those of the source. Destination 
filename defautts to that of the source (in 
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which case the “AS"/"ONTO* option defaults to 
FAS"). Initiates system message code 139 or 
il. 

eABORT PUT | Aborts the PUT in prooresspe i f anye 


Initiates system messacse code 18. 


eABORT FETCH Aborts the FETCH in progress» if any. 
Initiates system message code 19. | 


ePHONE hostname phoner-number 


If an autowdial unit 1s supplied» specifies 
the telephone number to be used the next time 
diai-out is initiated to establish connection 
to the specified host. (Diat-out is 
initiated by the .~ONLINE message.) 


QUIPUL MESSASES 


Under certain conditions» the SYCOM terminal system wttil supply 
information to the operator via the console typewriter. Some of 
these messages require an action by the operator. These messages 
wili be itdentifiec in the cperator*s manuat. For each of the 
SYCOM output message listec» a code number is giveng kif the 
message is returned to a program rather than displayed on a 
consoles this code number will be included to avoid the need for 
the program to parse the text of the messace. 


00 eCP-CHK | The card punch has detected a punch 
error on the tast card punched. 

01 oCPeNR The card punch is in a notwready state. 

02 eCR-CHK The card paader has detected a read 

| | error on the last card read. 

03 eCR-INV The card reader has detected an invalid 
punch in a cotumn other than column lL. 

04 eCR-NR The card reader is in a not-ready state. 

05 <ERR> The error pushbutton was depressed. 
Re-enter att information. 

06 eHOST EST Informs the operator that the system has 
established cr re~estabtished 


communications with the host system. 


07 eHOST TERM The terminal system has been placed in 
an off-tine mode due to: 


ie Having received an End of 
Transmission indication from the 
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08 


09 
16 
11 


12 


13 


eI NV-KBD 


oL P-CHK 


eLP-NR 


oMT x BE 


oMT x FE 


oMT x FT 
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host system. 


2e Direct result of keyboard entry 
DISCONNECT» which causes termination 
of ail activity. 


Indicates that an invalid operation has 
teen performed on keyboard inputs such 
as: 


1. Attempting to type in more than &¢ 
characters for an input message. 


2e Enabling keyboard tinput and typing 
at a rate of tess than one character 
every ten seconds» or not depressing 
the E0OM button at completion of 
input. 


3-e Input of a message which 1s 
inappropriates CQ aoJep typing 
".ONLINE® when the system ts already 
online to the specified host. 


4. Input of a message which is not 
defined. 


5-< Incorrectly inputting a message. 

6. Attempting to type in a message for 
the host system when sufficient 
space 1s unavailable. 

7e An error condition occurred during 
keyboard input» or an invatid key 
was depressed. Re-enter ati 
informatton. | 


The line printer has detected a print 
error on the tast tine printed. 


The. tine printer is in a notvwready 
state. 


Number of blocks that have been read is 
incorrect. 


Magnetic tape has incorrect formate. 
1. Record size nct corrects or. 
2e No ending tabet or file mark. © 


Foreign magnetic tape. Record format 
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14 


15 


16 


i7 


18 


19 


oMT x NL 
oMT x NR 
oMT x PE 


oMT x REEL 


MT x Wi 


oMT x 222722Z2/eHamMANM 
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incorrect. 


Ne label on tape or magnetic tape drive 


Xe 
Magnetic tape drive x not ready. 


Tape parity error on magnetic tape drive 
Ne 


Another reel of tape is required on 
magnetic tape drive x. 


Tape on untt x is write inhibited. 
t#rrr Cddddd) Tape fabeit information 


pertaining to tape on magnetic tape 
drive x: 


222222 = File name 


gemamm = Muitifile id or zeros 


rrr Reel number 


deddd = Creation date of SYCOM system 


The foitlowing messages are self-explanatory: 


20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 


32 


FILE <filenagze> NOT FOUND 


FILE <filename> LOCKEC 


FILE <fitename> FILE TYPE CANNOT BE TRANSMITTED 


CAN*T SCHEDULE NOW; 


TRY AGAIN LATER 


REQUEST SCHEDULEDs WILL SEND FILE <filename> ASAP 


FILE <filename> START TRANSMISSION 


FILE <filename> END 


TRANSMISSION 


ONTO-PACK CR USER-CODE NOT FOUND=--COPY ABORTED 


FILE <filename> IN USE AT DESTINATION=-COPY ABORTED 


FILE <fitiename> RECORD SIZE 1S TOO BIG 


FILE <filename> TOO MANY RECORDS 


REQUEST SCHECULED““REMOTE RJE OFFLINE 


UNABLE TO ESTABLISH COMMUNICATION 


3-26 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GRCUP B1800/B1700 SYCCM 
SANTA BARBARA PLANT | SDS 2222 2590 


33. UNABLE TO DIAL QuT 

34 NOW DIAL HOST 

35 ALREADY CONNECTED# CAN®*T DIAL 

36 «DIAL REQUESTED SUT NO ACU DEFINED 

37. INVALID PHONE NUMBER 

38 RJE IS CLOSING? CANNOT ACCEPT INPUT 

39 General syntax error Cexact text explains further) 
40 RJE CLOSING ON REQUEST FROM REMOTE SYSTEM 
41 RJE WILL CLOSE WHEN NEXT IDLE 

42 LOST CONNECTICN TO REMOTE SYSTEM RJE 

43 REMOTE RJE HAS GONE DOWN AND COME BACK UP 
4h THERE IS NO *FUT® IN PROGRESS TO ABORT 
45 PUT OF FILE <fitename> ABORTED 

46 THERE IS NO *FETCH® IS PROGRESS TO ABORT 
47 FETCH OF FILE <filtename> ABORTED 

48 SYCGOM NOW ONLINE TO HOST <hostname> 


COMMNUNICATICN ERROR MESSAGES 


Error reporting may be handled one of two WaySe The fottlowing 
errors may be reported individually as they occur: | 


49 eDSET*NR Pata Set (Modem) is in a notrready 
State. 
50 eL NeERR | Buffer — currently transmitted by the 


terminai system has been discarded 
because retry count has been exceeded. 


51 eNSP-EXP In the process cf transmission of data 
_te the hosts» the system has exceeded the 
adttowable number cf NO RESPONSE retries. 


$2 eRX“RTYS UP | In the process of data reception from 
the host» the system has exceeded the 
altowable number cof error retries. 


53 9 TX*RTYS-UP In the process of transmission of data 
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to the host» the system has exceeded the 
alicwable number cof retries. 


The operator should respcnd with either of the following options» 
only if one of the above error conditions has cccurred (refer to 
INPUT MESSAGES): 

eCONTINUE 

eDISCONTINUE 


Aiternately» aii errors may be reported by the following message; 


34 eRETRYS UP 


HOST SYSTEM MESSAGES 


Applicabie host system messages are found in the appropriate host 
master control program or tanguage operations manuals. 


ACCEPTASLE CHARACTERS FOR JERMINAL SPO 


The following List constitutes the set of characters which are 
acceptable for transmission from a remote station's SPO. The 
entry of any character not tisted shail either be deleted from 
the message prior to trans#issions or shatl invalidate the entire 
message prior to transmissions or shait invalidate the entire 
message at the remote station. | 
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0 through 9 

A through Z 

Blank or space 

Plus 

Minus or hyphen 
Asterisk 

Virgule (stash) 

Equat sign 

Doltar sign 

Cconmma 

Period 

Segicoton 

Colon 

Quote mark 

Left parenthesis 

Right parenthesis 
Greater symbol 

Less symbot | 

At sign 

Exctamatton mark 

Left bracket 

Right bracket 
Arcstroaphe 

Question mark 

Number mark 

Ampersand 

Percent sign 

Reverse virgule (stash) 
Up-arrow ) : 
Left arrcw or shifted 0 (Reversed for 
backspace functions nontransmittatbtle) 
oe Line feed (nonprinting) 
BELL Control G (Cnonprinting) 


OAVUNA TO wse DT HMHnrees 


wv” rT OORM 13 C2 ™ 


The following is a table of equivatence for allowable control 
characters. 


Carriage Return/Control C/ETX/End of Message 
Rubout (CDelete)/Contrcltl U/Error 


Left Arrow/Shifteac O/8ackspace 
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—  «- SYCOM TRANSMISSION QE PACKED DATA 
DATA RECORD FORMAT 


As in previous version of this protocot» data records within the 
Same transmission are separated by RS characters» and repeated 
blanks are compressed with the ESC-integer mechanism, but the 
method of representing non-printable characters is changed. The 
printable characters are those in the above tist (acceptable 
characters for terminal SPO)» except LF and BELL. 


If the record contains onty these characters» the first character 
of the record is nct a OLE. If the record contains any character 
not in this tists the first character of the record 1s a DLE» and 


the remainder of the rececrd contains transtated data. The 
originat data is transtated such that every 4 bits is mapped into 
an 88-bit printable character. This mapping is accomptished by 


prefixing the 4 bits of data with 4 bits of hex 4. 
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TERMINAL“ TOSPROGRAM COMMUNICATION 


The protocot supports a user at a terminal in one host connecting 
to an interactive applications program in another host» and using 
it as if he were locatty attached to the program. The main goat 
of this protocol is to minimize the visibitity of the interfacing 
softwares such that it appears to the user as tf were directly 
connacted to the applications program» and such that existing 
applications programs (Ce.ge» CANDE) may be utitized with a 
minimum of modification. 


Some ARPA Network terms that are useful in discussing this topic 


are “"user™ host and “server” host. The “user™ host is the host 
with the users at terminalis wishing to engage in interactive 
computing» and the “server™ host is the host that supplies the 


interactive service. 


The method for conveying terminal data between systems makes use 
of the device address fields DA1L DA2» to specify the terminal 
with which the data is associated. “"DAL» DA2" in this context is 
termed a “virtual station address"» and is the name used by user 
and server hosts to refer to a particutar terminati. The 
addressing scheme is as follows: 

te DAL and GA2 are ASCII letters» one upper case and the 

other lower case. | | 
Ze If "DAL» QOA2" is the transmit address for a particutar 


terminals» then "“DAZ» DAL" is the receive address for that 
terminai. 


3- When the user host refers to a terminal (Cby transmit 
address)» "DAIL" ais a dowerrcase Letter and "DA2" is an 
upper-case tetter. When the server host refers to the 
Same terminal » since the rotes of “transmit" and 
“receive*™ are reversed» "DAL" is an upper-case tetter and 
"DAZ" is a lower-case tetter. 


4e If a user host supports °N" different terminals 
| connecting to a particutuar server host» the user host 
refers to them by the following virtuat station addresses 
Cas transmit addresses): 
aA» DA» CAs eos ZAe aBs DOBe CBr eacr 


and the server host refers to the same terminalis by these 
virtual stations addresses (aiso as transmit addresses): 


Aa» Abs ACs coer AZe Bas BOs Beco oaee ° 


The user and server host decide independertly how many terminals 
they witli supports so these numbers wilt tikely be different. 
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The sequence of events in a remote interactive session are as 
follows: 


connection: | when SYCOM establishes connection to a host in 
response to an .-ONLINE command» it also attempts to establish a 
terminat*to-program connection»e Dy assigning a virtuat station 


address to this particular user and specifying it in a Connect 
message to the server host. This Connect message also describes 
the terminal*s characteristics. 


The server host receives the Connect message and checks to see if 
it can support the new ccnnections returns a Connect Reply > 
message specifying whether or not it can. If the connecton is 
successful» the server host makes this virtual station appear 
just like areal hardware terminat on that system that has been 
powered up and recegnized as ready (but not yet “signed on”). It 
makes the station ready in away determined by the nature of the 
host*s operating system. The server host also saves the terminal 
characteristics specified in the Connect message» and makes them 
accessitbie to user programs» preferably by storing them in the 
NDL tables. | 


disconnection: whenever SYCOM breaks connection due to. an 
eONLINE command to a new host or a «STOP commands it aiso breaks 
the terminat-to-prcgram connection Cif any) by sending a 
Disconnect message to the server host» specifying the virtual 
station address. | | 


The server host receives the Disconnect message» and does 
whatever %s appropriate itn that system to make that virtual 
terminat appear as though it was powered offs» or otherwise 


availabie for re-use. 


during the tife of the connection: if the terminal-to-program 
connection was established successfully» aii keyboard input 
entered by the user at his terminal Cexcept for tines beginning 
with a periods which are interpreted locaily) is transmitted to 
the server host» specifying the virtual terminal address as an 
RJE device address. The server host presents this input to 
whatever applications program or MCS that is currentiy attached 
to this terminal. 


Any terminat output text that is generated by the MCS or 
applications program is transmitted back to the user host» 
specifying the wirtual terminal address as an RJE device address. 
The user host SYCOM then displays this data on the user's 
terminai. : 7 


~—6QNE POSSIBLE IMPLEMENTATION 


The fottlowing is an outline of one possible method of 
implementing this protccot. It is presented here for 
ildiustrative purpeses ontlys it is not the responsibility of this 
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document or the RJE committee to develorg program togic for the 
individual plants. 


Ihe user host decides how many outbound connections witt be 
allowed> and in the NOL station section defines one station for 
each» specifying a receiveraddress/transmitcaddress pair of 
“Aa"/aaA" for the first» “Ab"/"bA™ for the second» and so on. 
Because of where these dectarations falt within the station 
sections they are assigned some Logicat station numbers. In the 
file section» a file family is declared tc have these Logical 
Stations as members. 


At initialization» SYCOM Cor some other MCS written for this 


purpose) opens the remote file pointing to these stations» and 
does a “remote file info" aperation to obtain from NDL the LSNs 
for these virtual stations, it places these numbers in a table 


to map the LSN of each user*s terminal into an LSN to reference 
the corresponding virtual Station. | 


When a user wishes to connect to the remote hosts» SYCOM finds the 
next available entry in his LSN table» and issues a Connect 
message for that virtual station address. On receipt of the 
Connect Repiy» SYCCM reports the cutcome tc the user. 


During the tife of the connections SYCOM transmits unexamined any 
data entered by the user at his terminat except commands 
prefixed by the SYCOM signal character) to the servers by doing a 
queue write to the LSN of the users virtual station. In 
processing this queue write> NDL maps the LSN into the 
appropriate virtual station address and transmits the data 
according to the SYCOM protocols with the virtual station address 
as the SYCOM device address. Any data read by the user NDL from 
the SYCOM tine with a device address like "Aa™» "Ab"» etc.» is 
presented to SYCOM» via his queue fite»s as input from the 
appropriate LSWN for this virtual station. SYCOM then 
interrogates the LSN table tc find the reat LSN of the associated 
users and writes the data to him via a queue write (the standard 
terminal-MCS interface). 


When the user wishes toa disconnect from the remote host» SYCQOM 
sends a Disconnect message to the servers specifying the virtual 
Station number of this user. | 


Ihe server host decides how many inbound connections witli be 
atlowed» and in the NDL station sections defines one station for 
each» specifying a receiveraddress/transmitraddress pair of 
“aA"/"Aa" for the first» and so on. Any MCS wishing to serve 
these stations (e.gex» CANDE) wilt include them in the family for 
their remote fite cectaration. 


The server NOL intercepts Connects» Disconnects» Device Not Ready = 
Suspends and Device Ready messages (Cuntlike att other device 
address "00" messages» which are routed to SYCOM). On receipt of 
a Connect message» NOL verifies that the addressed virtuael 
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Station exists and that some MCS is ready to read from it. I f 


not» NDL sends back an error response in a Connect Repty message, 
otherwise>s NDL makes the station ready Cin a system=dependent 
manner) and returns a success Connect Reply. 


During the dife of the connections any input data received by the 
server NOL for an enabled virtual station is conveyed to the 
waiting applications MCS through his aueue file in exactty the 
same manner as for tocal terminals. Any output data generated by 
the MCS and written to the virtual station through his queue file 
is transmitted to the user host» with the virtual station address 
as the RJE device address. | 


When the server NOL receives a Disconnect message» it marks the 
Station as not reacys just as it would if a tocat station powered 
off. | 


If either host finds that virtual terminal data is coming in too 
fast» it wilt senc a Device Not Ready = Suspend message for that 
virtual terminal. The receiving NDL witt process this»e and 
suspend further transmission untit a Oevice Ready message is 
received. | 


E-1 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GRCUP Bl180C/B1709 SYCOM 
SANTA BARBARA PLANT SDS 2222 2590 


PROGRAN@TOSPROGRAM COMMUNICATION 


A limited type of program-to-program communication is possible by 
adapting the above scheme fcr terminal-to-program communication. 
The RJE MCS wilt previde a mechanism Cof imptlementation-dependent 
nature) to attlow a tlocat program to masquerade as a terminal. 
This user program will format messages as if they were keybtoard 
inputs and the RJE systegam will send them to the server program. 
Likewise» the server program*s cutput will be presented to the 
user program as if it were terminal display data. 
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APPENDIX A = 1267 ASCII AND EBCOIC CHARACTER ASSIGNMENTS 


1967 st EGCDIC F8COIC | EBCOIC 
ASCII — GRAPHIC PUNCH CODE 
00 00 NUL 12-0°9-8-1 
Ol Qi : SOH 12-9-1 
02 02 STX : 12°9-2 
03 03 ETX 12°9-3 
04 37 EOT 9-7 

05 2C ENQ 0-9-8-5. 
06 2E AC K 0-9-B8=-6 
07 2F BEL 0-9-8-7 
08 | 16 | BS 11-9=-6 
09 05 HT 12°9°5 
OA 25 LF 0-9-5 

08 : 0&8 VT 1279-8=3 
Oc OC FF 12-9~8-4 
oD oOo CR | 12-9-8-5 
OE OE 7 $0 | | 12-9-8=-6 
OF OF SI 12~-9-8-7 
10 10 DLE b2e1 1-9 =5=1.. 
il il DC1 L11-9-1 
i2 12 0C2 —=11-°9-2 
13 | 13 DC3 11°9=3 
14 3C DC4 198-4 
15 | | 3D NAK , 9-8-5 

16 32 SYN g-2 

17 26 ETB 0-9-6 

18 18 CAN 11°9-8 
19 19 EM 117-9-8-1 
LA 3F SUB 9-8-7 

i8 27 ESC 0-9-7 

ic ic FS 11-9=-8-4 
10 iC GS 11°9-8=-5 
1£ 1E RS 11-9-8-6 
iF 1F US 11-99-87 
20 40 SP No Punches 
21 4F i i2~a-7 
22 TF ” G-7 

23 78 # 8-3 

24 56 $ | 11-873 
25 6c z 0-8-4 

26 50 g 12 

27 7C , 8-5 

2&@ 40 ( 12-85 
29 50 ) 11*8=5 
2A 5C * 11-8-4 
28 4E + 12-876 
2C 68 , 0-8=3 
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20 60 = i Ce 
2E 4B ° 1278-3 
oF 61 / O-1 

30 FO 0 0 

31 Fil i 1 

32 F 2 2 2 

33 F3 3 3 

34 F4 4, 4 

35 F5 5 5 

36 F 6 6 6 

37 F7 7 7 

38 F8 8 8 

39 F9 9 9 

3A 7A : 8-2 

38 5E 5 11-86 
3C 4C < 12-84 
3D 7E = G6 

3E 6E > 0-8-6 
3F 6F ? 0-8-7 
40 7C a 8-4 

41 Ci A 12-1 
42 C2 B 12-2 
43 C3 C 12°3 
44 C4 an?) 12-4 
45 C5 E 12°5 
46 C6 F 12-6 
47 C7 G 12-7 
48 ca Ho 12-8 
49 C9 I 12°9 
4A D1 J Lli-l 
48 C2 K TL=2 
4C D3 L 11-3 
4D D4 | 11-4 
aE 05 N Li=5 
4F C6 0 11-6 
50 C7 P i1-7 
51 Ca Q 11-8 
52 D9 R 11°9 
53 Ez S Q-2 

54 E3 T Q-3 

55 E4 U O-4 

56 E5 "| 0-5 

57 E6 W 0-6 

58 E7 X 0-7 

59 E8 Y 0-8 
SA. E9 2 0-9 

58 4A 'f 1278-2 
5C EC ON 0-8-2 
50 5A ] 11-é@-2 
55 | SF | up arrow 11-8-7 


SF | 60 undertitne 0-8-5 


A= 3 


BURRCUGHS CCRPORATICN | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GRCUP B1800/81700 SYCOM 
SANTA BARBARA PLANT | SOS 2222 2590 
60 79 | back apostrophe 8-1 

61 : 81 a 12°0-1 
62 82 b 12-072 
63 83 c 1276-3 
64 &4 d 12-074 
65 @5 e 12-C-5 
66 86 f 1270-6 
67 87 g 12°O-7 
68 &8 h L2-30-8 
69 a9 1 1270-9 
6A 91 j i2-1i-1l 
6B 92 k iz-1i-2 
6C 93 i L2-11-°3 
6D 94 ff L2-11-4 
6E 95 m 12-115 
6F 96 o 12-11-56 
79 97 p 12-1 1-7 
71 98 q 12711-°8 
v2 99 r A2711°9 
73 A2 Ss 11-072 
74 A3 t 11-0°3 
75 A4 u 11-074 
76 A5 v L11-0-5 
77 A6 Ww 11-0-6 
78 A7 x 11-O0-7 
79 Ae y 11°-0°8 
7A A9 P 4 11-079 
78 cc left brace 12-06 

7C 6A | 12-11 
70 CC right brace 11-0 

7E Al | tilde 1170-1 


TF 07 DEL Eceor7 
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